home *** CD-ROM | disk | FTP | other *** search
/ Programming Languages Suite / ProgramD2.iso / Languages / Masm V6.11 / CV.TX$ / CV.bin
Text File  |  1993-09-29  |  14KB  |  345 lines
  1.                                CV.TXT File
  2.  
  3.        Product Information for Microsoft(R) CodeView(TM), Version 4.01
  4.        Copyright (C) 1993, Microsoft Corporation.  All rights reserved.
  5.  
  6.      This document contains release notes for version 4.01 of Microsoft
  7.      CodeView for MS-DOS(R) and Microsoft Windows(TM) operating systems.
  8.      For more information on Microsoft CodeView, see Part 2, "The CodeView
  9.      Debugger," in the MASM Environment and Tools book.
  10.  
  11.  
  12.      Access to Function Code in Libraries
  13.      ------------------------------------
  14.      The MASM CodeView debugger and linker do not guarantee that the
  15.      name of an .OBJ file is the same name the debugger or linker uses
  16.      to access the function code. To be certain of function access, use
  17.      the /f option when compiling. To avoid problems, do not put code in
  18.      include files. If you do put code into include files, specify the
  19.      function as inline.
  20.  
  21.  
  22.      Application I/O When Debugging Can Cause Screen Corruption
  23.      ----------------------------------------------------------
  24.      If an application executes an I/O operation when the Flip/Swap
  25.      option is OFF, the screen may be corrupted.
  26.  
  27.  
  28.      .COM Files
  29.      ----------
  30.      CodeView 4.01 does not show source code when debugging .COM files.  
  31.      If you need to view source code, build your program as a small-model 
  32.      .EXE for debugging purposes.
  33.  
  34.  
  35.      Debugging Applications that Use a Mouse
  36.      ---------------------------------------
  37.      If you are using CV.EXE in a Windows MS-DOS session, and if you are
  38.      debugging an application that uses or alters the mouse, you must
  39.      specify the CodeView /M option to disable the mouse. This option is
  40.      necessary because the DPMI services provided by Windows 3.x in
  41.      enhanced mode do not allow for correctly saving and restoring the 
  42.      mouse state.
  43.  
  44.  
  45.      Debugging Code that Uses 32-Bit Registers
  46.      -----------------------------------------
  47.      CodeView 4.01 does not support single-stepping through code that
  48.      uses 32-bit registers while a DPMI server is present.  Windows 3.1
  49.      and 386-MAX are examples of DPMI servers.  If you need to single-
  50.      step through 32-bit code, set breakpoints and use the F8 key for 
  51.      single-stepping, or use an alternate debugger such as WDEB386 
  52.      (available in the Microsoft Windows Software Development Kit).
  53.      
  54.  
  55.      Debugging Locally on an 80286
  56.      -----------------------------
  57.      To run CodeView with Windows and debug locally on an 80286 computer,
  58.      the following files must be installed on the host computer:
  59.  
  60.      - CVW4.EXE (CodeView kernel)
  61.      - EEW0CXX.DLL (C++ expression evaluator)
  62.      - EEW0CAN.DLL (ANSI C expression evaluator)
  63.      - SHW0.DLL (symbol handler)
  64.      - EMW0W0.DLL (Windows-Windows execution model)
  65.      - TLW0LOC.DLL (local transport layer)
  66.      - TOOLHELP.DLL (Toolhelp)
  67.  
  68.  
  69.      Disable the Minimize On Use Option When Debugging
  70.      -------------------------------------------------
  71.      Running an application in CodeView for Windows can disable mouse and 
  72.      keyboard control if the Minimize On Use option is set in the Windows 
  73.      Program Manager.  This behavior occurs if you run an application 
  74.      using F5, restart from the Run menu, and begin to debug the 
  75.      application. To recover from this problem, use CTRL+ALT+SysRq to 
  76.      stop the application, issue the WKA command from within Codeview for 
  77.      Windows, and choose Exit from the File menu to return to Windows.
  78.  
  79.      
  80.      MS-DOS Session Running in a Window Does Not Have Mouse Support
  81.      --------------------------------------------------------------
  82.      Running CodeView with the /2 option in an MS-DOS session window does
  83.      not have mouse support. If you want mouse support, change the
  84.      MS-DOS session to full screen.
  85.  
  86.  
  87.      Recovering from "Internal Debugger Error"
  88.      -----------------------------------------
  89.      If CodeView generates an "Internal debugger error," restart your
  90.      system.
  91.  
  92.  
  93.      Remote Debugging with CodeView
  94.      ------------------------------
  95.      The required files needed on the host and the remote debugging
  96.      machine are operating-system dependent.
  97.  
  98.      For running CodeView under MS-DOS, the following files must be
  99.      installed on the MS-DOS host. These files are needed for all
  100.      execution models:
  101.  
  102.      - CV.EXE (CodeView kernel)
  103.      - SHD1.DLL (symbol handler)
  104.      - EED1CXX.DLL or EED1CAN.DLL (C++ expression evaluator or ANSI C
  105.        expression evaluator. Only one is needed, but EED1CXX.DLL
  106.        is required for programming with C++.  EED1CXX.DLL is the only
  107.        expression evaluator provided with MASM.)
  108.  
  109.      For remote debugging, you need to include the following statements in 
  110.      the [RCVCOM] section of your TOOLS.INI file:
  111.  
  112.      parameters: com1:9600
  113.  
  114.      or specify the command line:
  115.  
  116.      RCVCOM [-p com1:4800] [-r] [-?]
  117.  
  118.      where [ ] represents an optional parameter. See page 370 in the
  119.      Environment and Tools book for a description of these parameters.
  120.  
  121.      Remote debugging has three limitations:
  122.  
  123.      - You must specify that the shell be exclusive.
  124.  
  125.      - The recommended baud rate is 9600. If you experience any problems,
  126.        try decreasing the baud rate.
  127.  
  128.      - The shell should be specified as full-screen.
  129.  
  130.      Specify these settings in a .PIF file or in an MS-DOS session. Use 
  131.      the Settings command to specify these settings in an MS-DOS shell.
  132.  
  133.      If you install a CodeView DLL in a directory other than the one 
  134.      in which Setup installs it, specify the path of the DLL with the 
  135.      appropriate entry in your TOOLS.INI file. For example:
  136.  
  137.      SYMBOLHANDLER:C:\CV4\SHD1.DLL
  138.  
  139.      See also "Configuring CodeView with TOOLS.INI" on page 301, and
  140.      "Remote Debugging" on page 367, both in the Environment and Tools
  141.      book.
  142.  
  143.      The following four sections describe additional files you need for
  144.      specific hosts and targets.
  145.  
  146.  
  147.           DOS-Hosted, DOS-Targeted Debugging: Host Computer
  148.           -------------------------------------------------
  149.           If you are not doing remote debugging, these additional files
  150.           must be installed on the host computer for DOS-hosted,
  151.           DOS-targeted debugging:
  152.  
  153.           - EMD1D1.DLL (DOS host/DOS target execution model)
  154.           - TLD1LOC.DLL (local transport layer)
  155.  
  156.           If you are doing remote debugging, these additional files must
  157.           be installed on the host computer for DOS-hosted, DOS-targeted
  158.           debugging:
  159.  
  160.           - EMD1D1.DLL (DOS host/DOS target execution model)
  161.           - TLD1COM.DLL (COM port transport layer)
  162.  
  163.           To specify these transport options, use the TRANSPORT statement
  164.           in your TOOLS.INI file. The path must be specified as follows:
  165.  
  166.           TRANSPORT:C:\CV4\DLL\TLD1COM.DLL COM1:9600
  167.  
  168.           If you do not specify COM#:baud_rate in the TRANSPORT statement,
  169.           CodeView prompts you for this information.
  170.  
  171.           You must also add the Native entry to your TOOLS.INI file, giving
  172.           the execution model. The path is required:
  173.  
  174.           NATIVE:C:\CV4\EMD1D1.DLL (for DOS host/DOS target execution model)
  175.  
  176.  
  177.           DOS-Hosted, DOS-Targeted Debugging: Target Computer
  178.           ---------------------------------------------------
  179.           If you are doing remote DOS-hosted, DOS-targeted debugging, the 
  180.           following file must be installed on the target computer:
  181.  
  182.           - RCVCOM.EXE (remote CodeView for COM port)
  183.  
  184.  
  185.           DOS-Hosted, Windows-Targeted Debugging: Host Computer
  186.           -----------------------------------------------------
  187.           If you are doing remote debugging, these additional files must be
  188.           installed on the host computer for DOS-hosted, Windows-targeted
  189.           debugging:
  190.  
  191.           - EMD1W0.DLL (DOS host/Windows target execution model)
  192.           - TLD1COM.DLL (COM port transport layer)
  193.  
  194.  
  195.           DOS-Hosted, Windows-Targeted Debugging: Target Computer
  196.           -------------------------------------------------------
  197.           If you are doing remote debugging, the following additional files 
  198.           must be installed on the target computer for DOS-hosted, Windows-
  199.           targeted debugging:
  200.  
  201.           - RCVWCOM.EXE (remote CodeView for COM port)
  202.           - DMW0.EXE (debug monitor on Windows target)
  203.           - TOOLHELP.DLL (Toolhelp)
  204.  
  205.  
  206.      Removing CodeView 3.07 from SDK Program Manager Group
  207.      -----------------------------------------------------
  208.      You can safely remove CodeView 3.07 from your SDK Program Manager 
  209.      group to avoid confusion with the CodeView for Windows provided 
  210.      with MASM or Microsoft C/C++.
  211.  
  212.  
  213.      Running CodeView on an 80286 Computer
  214.      -------------------------------------
  215.      To run CVW on an 80286 computer, delete CVW.EXE and rename CVW4.EXE as
  216.      CVW.EXE. Local debugging on an 80286 computer with an EGA adapter
  217.      requires a secondary monitor. Single-screen debugging is not supported.
  218.      Local debugging on an EGA system requires CodeView to be invoked with the 
  219.      /2 command-line option.
  220.  
  221.  
  222.      Running Screen-Saver Programs While Debugging
  223.      ---------------------------------------------
  224.      Do not run screen savers such as Idlewild or AfterDark while debugging; 
  225.      their interactions with Windows can cause problems when debugging.
  226.  
  227.  
  228.      Setting the Scope of the Show Address Option in CodeView
  229.      --------------------------------------------------------
  230.      The printed documentation and Help incorrectly list the
  231.      syntax for setting the scope of the Show Address option in
  232.      the CodeView Command window (OL) as
  233.  
  234.           OL[<scope>]
  235.  
  236.      instead of
  237.  
  238.           OL[[<scope>][+|-]].
  239.  
  240.      The + and - switches can be used to turn other options on or
  241.      off, but will cause a syntax error if used to modify the scope
  242.      of the Show Address option.
  243.  
  244.      You can choose several options for the OL command at the same time.
  245.      Each time you use the OL command, the scopes you specify will be
  246.      turned on and the scopes you don't specify will be turned off.
  247.      The OL command does not toggle the scopes. For example, the command
  248.  
  249.           ollfg
  250.  
  251.      turns on lexical, function, and global scope while it turns off module
  252.      and executable scope.
  253.  
  254.  
  255.      .STARTUP Code
  256.      -------------
  257.      When CodeView information is generated in mixed-mode assembly, it
  258.      is possible for CodeView .STARTUP code to be misplaced. For 
  259.      example, from the source code
  260.  
  261.      .MODEL SMALL, C
  262.      .STACK
  263.      .CODE
  264.              .STARTUP
  265.              mov ax,0
  266.              .EXIT
  267.      END
  268.  
  269.      you would expect the following output:
  270.      
  271.      1:    .MODEL SMALL,C
  272.      2:    .STACK
  273.      3:    .CODE
  274.      4:            .STARTUP
  275.      214F:0000 BA5021         MOV       DX,2150
  276.      214F:0003 8EDA           MOV       DS,DX
  277.      214F:0005 8CD3           MOV       BX,SS
  278.      214F:0007 2BDA           SUB       BX,DX
  279.      214F:0009 D1E3           SHL       BX,1
  280.      214F:000B D1E3           SHL       BX,1
  281.      214F:000D D1E3           SHL       BX,1
  282.      214F:000F D1E3           SHL       BX,1
  283.      214F:0011 FA             CLI
  284.      214F:0012 8ED2           MOV       SS,DX
  285.      214F:0014 03E3           ADD       SP,BX
  286.      214F:0016 FB             STI
  287.      5:            mov ax,0
  288.      214F:0017 B80000         MOV       AX,0000
  289.      6:            .EXIT
  290.      
  291.      However, you will see the following:
  292.      
  293.      1:    .MODEL SMALL,C
  294.      2:    .STACK
  295.      3:    .CODE
  296.      4:            .STARTUP
  297.      5:            mov ax,0
  298.      214F:0000 BA5021         MOV       DX,2150
  299.      214F:0003 8EDA           MOV       DS,DX
  300.      214F:0005 8CD3           MOV       BX,SS
  301.      214F:0007 2BDA           SUB       BX,DX
  302.      214F:0009 D1E3           SHL       BX,1
  303.      214F:000B D1E3           SHL       BX,1
  304.      214F:000D D1E3           SHL       BX,1
  305.      214F:000F D1E3           SHL       BX,1
  306.      214F:0011 FA             CLI
  307.      214F:0012 8ED2           MOV       SS,DX
  308.      214F:0014 03E3           ADD       SP,BX
  309.      214F:0016 FB             STI
  310.      214F:0017 B80000         MOV       AX,0000
  311.      6:            .EXIT
  312.      
  313.      Note that line 5 has moved; however, the code will still run correctly.
  314.  
  315.  
  316.      Unloading DLLs When CodeView Terminates
  317.      ---------------------------------------
  318.      You may have applications that use the LoadLibrary function to load
  319.      DLLs to be used by the application. When CVW.EXE terminates or
  320.      restarts such applications, Windows terminates the application without
  321.      unloading DLLs or decrementing the DLL usage count. As a result, DLLs
  322.      still exist in the system. To unload DLLs, you must either exit
  323.      Windows and restart, or use a utility.
  324.  
  325.  
  326.      Unsuccessful Connection to Remote Terminal
  327.      ------------------------------------------
  328.      A remote monitor may appear to hang (the screen clears except for 
  329.      the CodeView sign-on banner) when connecting to it from a host computer
  330.      that is running the debug kernel. In order to resolve this situation, 
  331.      retry the connection when the debug kernel is not running on the 
  332.      host computer.
  333.  
  334.  
  335. ===========================================================================
  336.  
  337.  
  338.      Microsoft, MS, MS-DOS, and CodeView are registered trademarks, and
  339.      Windows is a trademark of Microsoft Corporation.  386-MAX is a
  340.      trademark of Qualitas Corporation.
  341.  
  342.      NOTE: Microsoft improves its languages documentation at the time of
  343.      reprinting, so some of the information in this file may already be
  344.      included in your manuals.
  345.